---
title: GwMatterRequest
summary: API reference for GwMatterRequest.
status: draft
owner: SAIF Claims BOF team
last_reviewed: 2026-08-21
library: SAIF.Application.Claim.Legal
reference_type: embedded
---

# GwMatterRequest

`GwMatterRequest` is a plain data-transfer object that carries the fields needed to create or update a Guidewire legal "matter" record from a hearing schedule (case number, status, secretary/attorney user IDs, matter date/type, and — for closed/settled/dismissed statuses — a computed `matterClosedEffDate`). It is built by `clsScheduleManager.SendDataToGw`/`clsAssignmentManager.SendDataToGw` and passed to the `GwMatterApi` API client, first as a `Create`/`RetrieveWithBody` call and, on failure, retried as an `Update` call ([Business rules](../../business-rules.md)). It has no base class and no persistence behavior of its own.

## Purpose
- Carry the case number, status, secretary/attorney user IDs, matter date, and matter type needed to create or update a Guidewire matter record.
- Compute and carry `matterClosedEffDate` when the schedule's status is closed, settled, or dismissed, so Guidewire reflects the matter's closure date.
- Decouple the Guidewire REST payload shape from the internal `clsLegalSchedule` business object.

## Context
- Namespace: `SAIF.Application.Claim.Legal`
- Assembly/package: `SAIF.Application.Claim.Legal.dll` (embedded library, constructed by `clsScheduleManager`/`clsAssignmentManager` and consumed by the `GwMatterApi` API client)

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| `New()` | `Public Sub New()`* | Default constructor for property-initializer-style construction before serialization to the Guidewire API request body. |
| `CaseNumber` | `Public Property CaseNumber As Decimal`* | Identifies the legal case the matter record corresponds to in Guidewire. |
| `Status` | `Public Property Status As String`* | Carries the schedule/case status used by Guidewire to determine the matter's current state. |
| `SecretaryUserId` | `Public Property SecretaryUserId As String`* | Identifies the assigned secretary's Guidewire/SAIF user ID for the matter record. |
| `AttorneyUserId` | `Public Property AttorneyUserId As String`* | Identifies the assigned attorney's Guidewire/SAIF user ID; matter sync is only attempted when this is populated ([Business rules](../../business-rules.md)). |
| `MatterDate` | `Public Property MatterDate As Date`* | Carries the hearing/matter date synchronized to Guidewire. |
| `MatterType` | `Public Property MatterType As String`* | Carries the schedule type (e.g., `HEAR`, `MED`) used by Guidewire to classify the matter. |
| `MatterClosedEffDate` | `Public Property MatterClosedEffDate As Date?`* | Carries the computed closure-effective date when the schedule's status is closed, settled, or dismissed; left unset otherwise. |

## Behavioral notes
- `MatterClosedEffDate` is only populated for closed/settled/dismissed statuses, mirroring the conditional logic in `clsScheduleManager.SendDataToGw`/`clsAssignmentManager.SendDataToGw`*.
- The matter sync using this DTO is skipped entirely when `AttorneyUserId` is blank, per this library's attorney-assignment gate ([Business rules](../../business-rules.md)).

## Constraints and usage notes
- As a plain DTO, `GwMatterRequest` performs no validation of its own; correctness of the values depends entirely on the caller (`clsScheduleManager`/`clsAssignmentManager`)**.

> **Note:** Statements marked with * were inferred from code structure, naming conventions, or
> contextual evidence where direct confirmation was not available in source artifacts. Statements
> marked with ** could not be confirmed; treat as unknown until verified.

## Sources
- `SAIF.Application.Claim.Legal\LegalNet\GwMatterRequest.vb`